home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / OpenGL-ftn / fglindexpointer.z / fglindexpointer
Encoding:
Text File  |  2002-10-03  |  11.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ffffggggllllIIIInnnnddddeeeexxxxPPPPooooiiiinnnntttteeeerrrr((((3333GGGG))))            OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee            ffffggggllllIIIInnnnddddeeeexxxxPPPPooooiiiinnnntttteeeerrrr((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ffffggggllllIIIInnnnddddeeeexxxxPPPPooooiiiinnnntttteeeerrrr - define an array of color indexes
  10.  
  11.  
  12. FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      SUBROUTINE ffffggggllllIIIInnnnddddeeeexxxxPPPPooooiiiinnnntttteeeerrrr( INTEGER*4 _t_y_p_e,
  14.                                  INTEGER*4 _s_t_r_i_d_e,
  15.                                  CHARACTER*8 _p_o_i_n_t_e_r )
  16.  
  17.  
  18. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  19.      _t_y_p_e     Specifies the data type of each color index in the array.
  20.               Symbolic constants GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE, GGGGLLLL____SSSSHHHHOOOORRRRTTTT, GGGGLLLL____IIIINNNNTTTT, GGGGLLLL____FFFFLLLLOOOOAAAATTTT,
  21.               and GGGGLLLL____DDDDOOOOUUUUBBBBLLLLEEEE are accepted. The initial value is GGGGLLLL____FFFFLLLLOOOOAAAATTTT.
  22.  
  23.      _s_t_r_i_d_e   Specifies the byte offset between consecutive color indexes.  If
  24.               _s_t_r_i_d_e is 0 (the initial value), the color indexes are
  25.               understood to be tightly packed in the array.  The initial value
  26.               is 0.
  27.  
  28.      _p_o_i_n_t_e_r  Specifies a pointer to the first index in the array.  The
  29.               initial value is 0.
  30.  
  31. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  32.      ffffggggllllIIIInnnnddddeeeexxxxPPPPooooiiiinnnntttteeeerrrr specifies the location and data format of an array of
  33.      color indexes to use when rendering.  _t_y_p_e specifies the data type of
  34.      each color index and _s_t_r_i_d_e gives the byte stride from one color index to
  35.      the next allowing vertices and attributes to be packed into a single
  36.      array or stored in separate arrays.  (Single-array storage may be more
  37.      efficient on some implementations; see ffffggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss.)
  38.  
  39.      _t_y_p_e, _s_t_r_i_d_e, and _p_o_i_n_t_e_r are saved as client-side state.
  40.  
  41.      The color index array is initially disabled. To enable and disable the
  42.      array, call ffffggggllllEEEEnnnnaaaabbbblllleeeeCCCClllliiiieeeennnnttttSSSSttttaaaatttteeee and ffffggggllllDDDDiiiissssaaaabbbblllleeeeCCCClllliiiieeeennnnttttSSSSttttaaaatttteeee with the
  43.      argument GGGGLLLL____IIIINNNNDDDDEEEEXXXX____AAAARRRRRRRRAAAAYYYY. If enabled, the color index array is used when
  44.      ffffggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss, ffffggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss or ffffggggllllAAAArrrrrrrraaaayyyyEEEElllleeeemmmmeeeennnntttt is called.
  45.  
  46.      Use ffffggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss to construct a sequence of primitives (all of the same
  47.      type) from prespecified vertex and vertex attribute arrays.  Use
  48.      ffffggggllllAAAArrrrrrrraaaayyyyEEEElllleeeemmmmeeeennnntttt to specify primitives by indexing vertices and vertex
  49.      attributes and ffffggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss to construct a sequence of primitives by
  50.      indexing vertices and vertex attributes.
  51.  
  52. NNNNOOOOTTTTEEEESSSS
  53.      ffffggggllllIIIInnnnddddeeeexxxxPPPPooooiiiinnnntttteeeerrrr is available only if the GL version is 1.1 or greater.
  54.  
  55.      The color index array is initially disabled, and it isn't accessed when
  56.      ffffggggllllAAAArrrrrrrraaaayyyyEEEElllleeeemmmmeeeennnntttt, ffffggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss, or ffffggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss is called.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ffffggggllllIIIInnnnddddeeeexxxxPPPPooooiiiinnnntttteeeerrrr((((3333GGGG))))            OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee            ffffggggllllIIIInnnnddddeeeexxxxPPPPooooiiiinnnntttteeeerrrr((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      Execution of ffffggggllllIIIInnnnddddeeeexxxxPPPPooooiiiinnnntttteeeerrrr is not allowed between ffffggggllllBBBBeeeeggggiiiinnnn and the
  75.      corresponding ffffggggllllEEEEnnnndddd, but an error may or may not be generated. If an
  76.      error is not generated, the operation is undefined.
  77.  
  78.      ffffggggllllIIIInnnnddddeeeexxxxPPPPooooiiiinnnntttteeeerrrr is typically implemented on the client side.
  79.  
  80.      Since the color index array parameters are client-side state, they are
  81.      not saved or restored by ffffggggllllPPPPuuuusssshhhhAAAAttttttttrrrriiiibbbb and ffffggggllllPPPPooooppppAAAAttttttttrrrriiiibbbb.  Use
  82.      ffffggggllllPPPPuuuusssshhhhCCCClllliiiieeeennnnttttAAAAttttttttrrrriiiibbbb and ffffggggllllPPPPooooppppCCCClllliiiieeeennnnttttAAAAttttttttrrrriiiibbbb instead.
  83.  
  84. EEEERRRRRRRROOOORRRRSSSS
  85.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _t_y_p_e is not an accepted value.
  86.  
  87.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _s_t_r_i_d_e is negative.
  88.  
  89. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  90.      ffffggggllllIIIIssssEEEEnnnnaaaabbbblllleeeedddd with argument GGGGLLLL____IIIINNNNDDDDEEEEXXXX____AAAARRRRRRRRAAAAYYYY
  91.      ffffggggllllGGGGeeeetttt with argument GGGGLLLL____IIIINNNNDDDDEEEEXXXX____AAAARRRRRRRRAAAAYYYY____TTTTYYYYPPPPEEEE
  92.      ffffggggllllGGGGeeeetttt with argument GGGGLLLL____IIIINNNNDDDDEEEEXXXX____AAAARRRRRRRRAAAAYYYY____SSSSTTTTRRRRIIIIDDDDEEEE
  93.      ffffggggllllGGGGeeeettttPPPPooooiiiinnnntttteeeerrrrvvvv with argument GGGGLLLL____IIIINNNNDDDDEEEEXXXX____AAAARRRRRRRRAAAAYYYY____PPPPOOOOIIIINNNNTTTTEEEERRRR
  94.  
  95.  
  96. MMMMAAAACCCCHHHHIIIINNNNEEEE DDDDEEEEPPPPEEEENNNNDDDDEEEENNNNCCCCIIIIEEEESSSS
  97.      On RealityEngine, RealityEngine2, and VTX systems, do not enable or
  98.      disable GGGGLLLL____VVVVEEEERRRRTTTTEEEEXXXX____AAAARRRRRRRRAAAAYYYY, GGGGLLLL____VVVVEEEERRRRTTTTEEEEXXXX____AAAARRRRRRRRAAAAYYYY____EEEEXXXXTTTT, GGGGLLLL____NNNNOOOORRRRMMMMAAAALLLL____AAAARRRRRRRRAAAAYYYY,
  99.      GGGGLLLL____NNNNOOOORRRRMMMMAAAALLLL____AAAARRRRRRRRAAAAYYYY____EEEEXXXXTTTT, GGGGLLLL____CCCCOOOOLLLLOOOORRRR____AAAARRRRRRRRAAAAYYYY, GGGGLLLL____CCCCOOOOLLLLOOOORRRR____AAAARRRRRRRRAAAAYYYY____EEEEXXXXTTTT,
  100.      GGGGLLLL____IIIINNNNDDDDEEEEXXXX____AAAARRRRRRRRAAAAYYYY,GGGGLLLL____IIIINNNNDDDDEEEEXXXX____AAAARRRRRRRRAAAAYYYY____EEEEXXXXTTTT, GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDD____AAAARRRRRRRRAAAAYYYY,
  101.      GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDD____AAAARRRRRRRRAAAAYYYY____EEEEXXXXTTTT, GGGGLLLL____EEEEDDDDGGGGEEEE____FFFFLLLLAAAAGGGG____AAAARRRRRRRRAAAAYYYY or GGGGLLLL____EEEEDDDDGGGGEEEE____FFFFLLLLAAAAGGGG____AAAARRRRRRRRAAAAYYYY____EEEEXXXXTTTT
  102.      between a call to ffffggggllllNNNNeeeewwwwLLLLiiiisssstttt and the corresponding call to ffffggggllllEEEEnnnnddddLLLLiiiisssstttt.
  103.      Instead, enable or disable before the call to ffffggggllllNNNNeeeewwwwLLLLiiiisssstttt.
  104.  
  105.  
  106. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  107.      ffffggggllllAAAArrrrrrrraaaayyyyEEEElllleeeemmmmeeeennnntttt, ffffggggllllCCCCoooolllloooorrrrPPPPooooiiiinnnntttteeeerrrr, ffffggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss, ffffggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss,
  108.      ffffggggllllEEEEddddggggeeeeFFFFllllaaaaggggPPPPooooiiiinnnntttteeeerrrr, ffffggggllllEEEEnnnnaaaabbbblllleeee, ffffggggllllGGGGeeeettttPPPPooooiiiinnnntttteeeerrrrvvvv, ffffggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss,
  109.      ffffggggllllNNNNoooorrrrmmmmaaaallllPPPPooooiiiinnnntttteeeerrrr, ffffggggllllPPPPooooppppCCCClllliiiieeeennnnttttAAAAttttttttrrrriiiibbbb, ffffggggllllPPPPuuuusssshhhhCCCClllliiiieeeennnnttttAAAAttttttttrrrriiiibbbb,
  110.      ffffggggllllTTTTeeeexxxxCCCCoooooooorrrrddddPPPPooooiiiinnnntttteeeerrrr, ffffggggllllVVVVeeeerrrrtttteeeexxxxPPPPooooiiiinnnntttteeeerrrr
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.